home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / usenet / sources / volume2 / dos / fs / files12.dcs < prev    next >
Internet Message Format  |  1988-10-25  |  7KB
  1. Path: xanth!nic.MR.NET!hal!cwjcc!tut.cis.ohio-state.edu!mailrus!ulowell!page
  2. From: page@swan.ulowell.edu (Bob Page)
  3. Newsgroups: comp.sources.amiga
  4. Subject: v02i020:  files - file catalog utility V1.2 (docs)
  5. Message-ID: <9825@swan.ulowell.edu>
  6. Date: 25 Oct 88 01:15:59 GMT
  7. Organization: University of Lowell, Computer Science Dept.
  8. Lines: 172
  9. Approved: page@swan.ulowell.edu
  10.  
  11. Submitted-by: dillon@cory.berkeley.edu (Matt Dillon)
  12. Posting-number: Volume 2, Issue 20
  13. Archive-name: dos/fs/files12.docs
  14.  
  15. # This is a shell archive.  Remove anything before this line
  16. # then unpack it by saving it in a file and typing "sh file"
  17. # (Files unpacked will be owned by you and have default permissions).
  18. # This archive contains the following files:
  19. #    files.doc
  20. #
  21. if `test ! -s files.doc`
  22. then
  23. echo "writing files.doc"
  24. cat > files.doc << '\Rogue\Monster\'
  25.  
  26.  
  27.                FILE CATALOG UTILITY
  28.  
  29. By Matthew Dillon.
  30.  
  31.     dillon@ucbvax.berkeley.edu    (ARPANET)
  32.     ..!ihnp4!ucbvax!dillon        (USENET)
  33.  
  34.     Matthew Dillon
  35.     891 Regal Rd.
  36.     Berkeley, California 94708
  37.  
  38.     USA
  39.  
  40.  
  41. WINDOW TITLE:
  42.     Holds operational status.  Normally holds two numbers SELECTED/ENTRIES
  43.     Where SELECTED is the number of files currently selected for viewing.
  44.     The ALL gadget selects all entries for viewing.
  45.  
  46. PATTERN:
  47.     Entering a wildcard pattern here selects for viewing those entries
  48.     (file name or comment) which matches the pattern.  "+pattern" adds
  49.     entries to the currently selected list, and "-pattern" removes entries
  50.     from the currently selected list. "pattern" alone is equivalent to
  51.     "-*" "+pattern".  Note that if looking for a specific program you need
  52.     to specify it like:  "*viacom.arc" with the "*" in front to handle any
  53.     prefix to the file.
  54.  
  55.     '*' and '?' are acceptable wildcards.  Any combination is allowed.  The
  56.     search is case independant.
  57.  
  58. VOLUME:
  59.     Entering a disk volume name (e.g. "df1:") or directory path
  60.     (e.g. "df1:src/files") causes that volume/directory to be searched
  61.     and all files to be added to the database.    The FULL path name is
  62.     determined, including the volume name, independant of the original
  63.     specification.  This means you can say "df1:" instead of "mydisk:" and
  64.     entries in the database will begin "mydisk:blah..".
  65.  
  66.     When I say 'volume' in the following description I mean either a
  67.     directory or volume.
  68.  
  69.     This also serves to UPDATE entries in the database.  Specifically, if
  70.     the volume already exists in the database new files are added and files
  71.     which no longer exist (in the volume) are removed.  Any comments which
  72.     you have added to the database are KEPT.  Note, however, that if a
  73.     file contains a comment field and the database entry also has a comment
  74.     field the database entry's comment field is used.
  75.  
  76.     Example:  To add a whole lot of floppies simply specify DF0:, hit
  77.     return, then place new floppies in DF0: and hit return without having
  78.     to retype DF0: or even reselect the string gadget.
  79.  
  80.     NOTE!!  Each disk should have a unique volume name or it will exclude
  81.     other disks!  Now that isn't too much to ask for, is it?
  82.  
  83. COMMENT:
  84.     After selecting a file with the left mouse button you may enter a
  85.     comment for it.  The comment field is automatically activated after
  86.     selection and any previous comment loaded into the field.
  87.  
  88. SLIDE BAR:
  89.     The slide bar is used to move around in the database.  Normally the
  90.     database is too large for much resolution on the slide bar (mine is
  91.     3821 entries at the moment), in which case one normally selects a
  92.     subsection of the database with the PATTERN field before moving around.
  93.  
  94.     The display area places the comment after the longest file path in
  95.     the currently selected subset, so you might have to make the window
  96.     wider to see the comments.
  97.  
  98. INFO:
  99.     Program info.  My name in lights!
  100.  
  101. DEL:
  102.     Delete the highlighted item or the currently selected subsection of
  103.     the database if there is no highlighted item.  YOU CAN DELETE THE
  104.     ENTIRE DATABASE THIS WAY!! BUT...
  105.  
  106. UNDO:
  107.     Undo the last delete operation.  For best results hit immediately
  108.     after a DEL.
  109.  
  110. ALL:
  111.     Selects the entire database for viewing.
  112.  
  113. ----------------------------------------------------------------------------
  114.                 MENUS
  115.  
  116.     SAVE    save database under previously loaded name
  117.     SAVEAS    save database under a new name
  118.     LOADDEF    load the default database (s:catalog.db or previously
  119.          loaded file).    Information is appended to the memory
  120.          image.
  121.     LOAD    specify a filename to load as the database.  Information
  122.          is appended as in LOADDEF
  123.     QUIT    Quit the program (for those who do not know how to use
  124.         the close gadget)
  125.     ADDKILLPAT    Create a kill entry in the database (@@KILLPAT).  The
  126.         comment field of this entry is a pattern.  If the pattern
  127.         matches an about-to-be-loaded path the path is not loaded.
  128.         Any number of kill entries may exist in the database.
  129.  
  130.         Example:    set the comment to *.o, and no object files
  131.                 will be added from new volumes.
  132.  
  133.  
  134.     The filerequester code was provided by Peter Da Silva and hacked
  135.     moderately.  All other code is my own.
  136.  
  137. ----------------------------------------------------------------------------
  138.                 LIMITATIONS
  139.  
  140.     -Volume Names may not begin with @@
  141.     -Volume Names beginning with '+' and '-' are o.k., but difficult to
  142.      specify in the PATTERN field due to the special meaning of '+' & '-'.
  143.     -Full File Paths and comments must be smaller than 128 characters each
  144.     -There is no limitation to the database size except for the amount of
  145.      memory you have.
  146.  
  147.  
  148. ----------------------------------------------------------------------------
  149.                 FILE FORMAT
  150.  
  151. The database is an ascii file.    The first line is a number (3) specifying
  152. the number of lines per entry.    The next line starts the first entry, with
  153. 3 lines per entry (and no extra lines at the end of the database).  No tabs
  154. are allowed.  The initial number is used for upward compatibility when/if
  155. I add more information to the database.  The three lines are:
  156.  
  157.     1    -file name
  158.     2    -file comment
  159.     3    -file size (bytes)
  160.  
  161. Future additions will also include:
  162.     4    -date
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169. \Rogue\Monster\
  170. else
  171.   echo "will not over write files.doc"
  172. fi
  173. if [ `wc -c files.doc | awk '{printf $1}'` -ne 5309 ]
  174. then
  175. echo `wc -c files.doc | awk '{print "Got " $1 ", Expected " 5309}'`
  176. fi
  177. echo "Finished archive 1 of 1"
  178. # if you want to concatenate archives, remove anything after this line
  179. exit
  180. -- 
  181. Bob Page, U of Lowell CS Dept.  page@swan.ulowell.edu  ulowell!page
  182. Have five nice days.
  183.